Inside Macintosh: Open Transport /

Chapter 10 - AppleTalk Addressing / AppleTalk Addressing Reference

Functions

OTExtractNBPZone

Extracts the zone part of an NBP name from an NBP entity structure.

C INTERFACE

void OTExtractNBPZone(const NBPEntity* nbpEntity, char* zone);

C++ INTERFACES

None. C++ applications use the C interface to this function.

PARAMETERS

nbpEntity

A pointer to the NBP entity structure from which you wish to extract an address.

type

A pointer to the string buffer in which to store the type portion of an NBP name string that you wish to extract from the NBP entity.

DESCRIPTION

The OTExtractNBPZone function extracts the zone part of an NBP name from the specified NBP entity structure and stores it into the string buffer specified by the zone parameter. This function inserts a backslash (\) in front of any backslash, colon (:), or at-sign (@) it finds in an NBP name so that mapper functions can use a correctly formatted NBP name.

SEE ALSO

The NBP entity structure is described in the section "The NBP Entity Structure," beginning on page 10-20.

The NBP address structure is described in the section "The NBP Address Structure," beginning on page 10-17.

To store the name, type, and zone parts of an NBP name in an NBP entity structure, use the OTSetNBPName function (page 10-31), the OTSetNBPType function (page 10-32), and the OTSetNBPZone function (page 10-34), respectively.

To extract the name and type parts of an NBP name in an NBP entity structure, use the OTExtractNBPName function (page 10-35) and the OTExtractNBPType function (page 10-36) , respectively.